home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / os2 / masndos2.zip / MAILSEND.TXT < prev    next >
Text File  |  1996-03-01  |  12KB  |  351 lines
  1.  
  2.             DataEnter, Michael Kocum
  3.             Taborstrasse 27/23
  4.             A-1020 Vienna
  5.             AUSTRIA
  6.  
  7.         CIS: 70143,1667
  8.         MHS: MICHAEL @ DEMK (via CSERVE)
  9.    Internet: michael@demk.co.at
  10.         Fax: +43/1/214 38 29
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Introduction to MailSend
  17. ------------------------
  18.  
  19. MailSend is a add-on for Microsoft Mail and Windows for Workgroups.
  20. MailRed sends messages from the command line or from batch files.
  21.  
  22.  
  23. Some suggestion as to what you can do:
  24.  
  25. -After you do your overnight backup, send the backup log to your mailbox
  26.  
  27. -Send your monthly report to your boss
  28.  
  29. -In a more sophisticated enviroment, you can export data out of your
  30.  application, pass it to MailSend as an attachment. MailSend will send
  31.  it to the destination and there you can use MailExtr to convert it back
  32.  to a file and import it in your application. In fact, a lot of
  33.  customers make their database updates via MailSend and MailExtr.
  34.  
  35.  
  36.  
  37. System Requirements
  38. -------------------
  39.  
  40.   DOS   version :  DOS 3.3 or higher
  41.   Win16 version :  Windows 3.1 or higher
  42.   Win32 version :  Windows NT 3.1 or higher or Windows 95 or higher
  43.   OS/2  version :  OS/2 2.x or higher
  44.  
  45.   Microsoft Mail, version 3.2 or above or
  46.   Windows for Workgroups, versions 3.11 or above or
  47.   MAPI.DLL ( optional in Win16 version ) or
  48.   MAPI32.DLL ( optional in Win32 version )
  49.  
  50.  
  51. Installation
  52. ------------
  53.  
  54.   - Create a directory of your choice copy MAILSEND.EXE into this
  55.     directory.
  56.  
  57.   - Use your editor to create a MAILSEND.DEF file for your common used
  58.     arguments (see section "Using MAILSEND.DEF").
  59.  
  60.  
  61. Arguments
  62. ---------
  63.  
  64. MailSend uses the following arguments:
  65.  
  66.  
  67. -mt                  Use MAPI as transport service
  68.                      ( Win16 and Win32 version only )
  69.  
  70.  
  71. -f<Mailbox>          Mailbox name
  72.                      or transport service name of you use the Exchange
  73.                      Client and MAPI (-mt)
  74.  
  75.                      Note: Argument is not necessary if you use MAPI (-mt).
  76.  
  77.  
  78. -p<Password>         Mailbox password (default is no password)
  79.  
  80.                      Note: Argument is not necessary if you use MAPI (-mt).
  81.  
  82.  
  83. -t<Dest>             Destination address in full Microsoft format
  84.                      (Network/Postoffice/User) or in the format your
  85.                      gateway requires it.
  86.  
  87.                      Note: When using MAPI (-mt) on a Windows NT
  88.                            machine running MSMail for NT, the user part
  89.                            of the address is case sensitive.
  90.  
  91.                      If you are sending a message to a user on you own
  92.                      postoffice, you can use a simpler addressing format
  93.                      and let MailSend resolve the address. You will find
  94.                      more information about resolving addresses in the
  95.                      section "Resolving address" below.
  96.  
  97.                      You can send to multiply addresses by using more
  98.                      than one -t switch.
  99.  
  100.                      Note: Resolving an address is not available if you
  101.                            use MAPI (-mt)
  102.  
  103.  
  104. -c<Dest>             Carbon Copy ( CC ) destination address in full
  105.                      Microsoft format (Network/Postoffice/User) or in
  106.                      the format your gateway requires it.
  107.  
  108.  
  109. -s<Subject>          Subject for message
  110.  
  111.  
  112. -d<Drive>            Drive where MailData is located (default drive M)
  113.                      or full path to MailData.
  114.  
  115.                      Note: Argument is not necessary if you use MAPI (-mt).
  116.  
  117.                      If MailSend does not find a postoffice on the given
  118.                      drive, it will scan all your drives from C: to Z:
  119.                      for a postoffice and uses the first one it finds.
  120.  
  121.                      If there is still no postoffice found, it will try
  122.                      to find your MSMAIL.INI and read the postoffice
  123.                      drive from it.
  124.  
  125.                      In the unlikly event that MailSend can't find the
  126.                      postoffice in this way, it will give you an error.
  127.  
  128.                      You can start MailSend with the -l option and
  129.                      it will help you finding the postoffice.
  130.  
  131.  
  132. -i<ImportFile>       File to import for message bod. If the file size is
  133.                      more than 32KB it will be converted to an
  134.                      attachment.
  135.  
  136.  
  137. -a<AttachFile>       File(s) to attach to message. Multiple files and
  138.                      wildcards are allowed.
  139.  
  140.  
  141. -b<Priority>         Priority for the message (1-5 or R for Recipient)
  142.  
  143.  
  144. -1                   Enable Single To Mode.
  145.                      In Single To Mode, MailSend sends one message for
  146.                      every To address ( -t ) and every CC address ( -c )
  147.                      instead of a single message with all the To's and
  148.                      CC's. This is useful if you want to send a message
  149.                      to more that one address, but each recipient should
  150.                      not see all the other recipients.
  151.  
  152.  
  153. -w                   Wait on exit for a keypress.
  154.                      Useful if you start MailSend as a second task and
  155.                      you want to see the screen output before MailSend
  156.                      exits.
  157.  
  158.  
  159. -@<ArgFile>          Read additional argument from a file (-@FILE.EXT)
  160.  
  161.                      You can create the file with your editor or
  162.                      with NotePad and write one line for every argument.
  163.                      ( see example for ARG.TXT below )
  164.  
  165.  
  166. -l                   Scans your drives for a postoffice
  167.  
  168.                      If you have no idea where your postoffice is
  169.                      located and MailSend will not find it, you can use
  170.                      this option. After completion, write down the path
  171.                      and use it the next time you send a message.
  172.  
  173.  
  174. Samples
  175. -------
  176.  
  177.  
  178.    To send mail from Admin with a password of PASSWORD to
  179.    Rick (located on Network NET and postoffice POST) and your maildrive
  180.    is M: use the following.
  181.  
  182.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestmail
  183.  
  184.  
  185.    To attach a file to the message:
  186.  
  187.    MailSend -fAdmin -pPassword -dM -tNet/Post/Rick -sTestMail -aATTACH.XLS
  188.  
  189.    Same as above with an argument file:
  190.  
  191.    MailSend -@ARG.TXT
  192.  
  193.  
  194. Sample ARG.TXT
  195. --------------
  196.  
  197.    -fAdmin
  198.    -pPassword
  199.    -dM
  200.    -tNet/Post/Rick
  201.    -sTestMail
  202.    -aATTACH.XLS
  203.    <End of file>
  204.  
  205.  
  206.  
  207. Using MAILSEND.DEF
  208. ------------------
  209.  
  210. Every time MailSend starts its looks for MAILSEND.DEF in the directory
  211. where MAILSEND.EXE resides. MAILSEND.DEF can be used to provide MailSend
  212. with default arguments. If your postoffice is always at the same
  213. drive its a good idea to use a MAILSEND.DEF to use your drive as the
  214. default.
  215.  
  216. You can create MAILSEND.DEF with your editor or with NotePad and
  217. write one line for every argument.
  218.  
  219. Here is a sample MAILSEND.DEF:
  220.  
  221.    -dM
  222.    <End of file>
  223.  
  224.  
  225.  
  226.  
  227. Resolving address
  228. -----------------
  229.  
  230. Note: Resolving an address is not available if you use MAPI (-mt)
  231.  
  232. MailSend can resolve your address to a full address. This is a real
  233. shortcut if you send a message to a user in your own network/postoffice
  234. or if you don't know your network/postoffice. WFW and Win95 users can
  235. always use this option, because there is only one postoffice.
  236.  
  237. How it works:
  238.  
  239. When MailSend detects that there is no valid address given, it will take
  240. a look inside the global address book and will try to find an address
  241. with matches your input. First it looks at every mailbox name and then
  242. at every alias name on you postoffice, and if it finds one, its uses its
  243. address.
  244.  
  245. Assume your network is called "Network" and your postoffice is
  246. "Postoffice" and you want to send to a mailbox "MillerC" with an alias
  247. of "Carl Miller".
  248.  
  249. The traditional way is to use -tNetwork/Postoffice/MillerC, which is
  250. the full address of "MillerC".
  251.  
  252. The shortcut is to use -tMillerC instead of -tNetwork/Postoffice/MillerC
  253.  
  254. MailSend now searches for a mailbox "MillerC" and resolves the address.
  255.  
  256. Another way is to use -tCarl Miller or -tCarlMiller
  257. (The space does not care when resolving addresse). In this example
  258. MailSend searches for an alias name of "CarlMiller".
  259.  
  260. If you know that there is only one alias name starting with "Carl" you
  261. can further trim it down to -tCarl and MailSend will find it.
  262.  
  263.  
  264.  
  265. Return Codes
  266. ------------
  267.  
  268. MailSend supports the following return codes (errorlevel):
  269.  
  270.    0   Message sent
  271.    1   Message not sent
  272.  
  273.  
  274.  
  275. More information
  276. ----------------
  277.  
  278. Enclosed you will find FAQ.TXT which answers frequently asked questions
  279.  
  280.  
  281.  
  282. Licensing Agreement
  283. -------------------
  284.  
  285.     MailSend (c) is copyrighted 1993-1995 by DataEnter, Michael Kocum,
  286.     portions (c) Microsoft Corp.
  287.  
  288.     This product and its documentation may not, in whole or in part, be
  289.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  290.     system, or translated into any other natural or computer language, in
  291.     any form or by any means whatsoever, be it electronic, mechanical,
  292.     magnetic, optical, manual or otherwise, without the prior written
  293.     consent of DataEnter.
  294.  
  295.     DataEnter makes no warranty or representation, either expressed or
  296.     implied, with respect to the product MailSend and its
  297.     documentation, their quality, perfomance, merchantability, or fitness
  298.     for a particular purpose. DataEnter reserves the right to revise the
  299.     user's guide and make changes in the content without obligation to
  300.     notify any person or organization of such a change.
  301.  
  302.     In no event will DataEnter be liable for any direct, indirect,
  303.     special, incidental or consequential damages, real or imagined,
  304.     resulting from the use or purchase of this software.
  305.     Under no circumstances shall DataEnter's liability for damages
  306.     exceed the price paid for the software license.
  307.  
  308.     Should any remedy hereunder be determined to have failed, all
  309.     limitations of liability and exclusion of damages set forth above
  310.     shall remain in full force and effect.
  311.  
  312.     The extent of the DataEnter's warranty for the software and its
  313.     documentation is limited to physical defects of the distribution media
  314.     containing the software. Contact DataEnter to obtain return
  315.     authorization for the replacement diskette within 30 days of the
  316.     original date of purchase. Any further statement made by agents,
  317.     employees, distributors or dealers of DataEnter do not constitute
  318.     warranties and are not binding. No employee of DataEnter has the
  319.     authority to modify any portion of this warranty.
  320.  
  321.     All brand and product names we refer to in the documentation are used
  322.     solely for identification purposes and may be trademarks of other
  323.     companies.
  324.  
  325.     DataEnter, (the licensor) grants the buyer (the licensee)
  326.     the right to use this copy of MailSend (the program)
  327.     on a single postoffice at a single location as long as the
  328.     licensee complies with the terms of this license. The licensor
  329.     reserves the right to terminate this license if the licensee
  330.     violates any part of the agreement.
  331.  
  332.     The licensee agrees to make copies of the program only for backup
  333.     purposes. The licensee agrees not to copy the documentation and to
  334.     take all necessary precautions to ensure that the backup copies of the
  335.     software are not distributed to or acquired by other parties.
  336.  
  337.     Microsoft Mail is a trademark of Microsoft Corp.
  338.     Windows for Workgroups is a trademark of Microsoft Corp.
  339.     Windows NT is a trademark of Microsoft Corp.
  340.     Windows Windows 95 is a trademark of Microsoft Corp.
  341.     OS/2 is a trademark of IBM Corp.
  342.  
  343. History:
  344. --------
  345.  
  346. v3.00             Released
  347. v3.01   01.03.96  Fixed a bug in parsing the command line
  348.                   Fixed online description
  349.  
  350.  
  351.